home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp48hor1 / uflags.doc < prev    next >
Text File  |  1995-03-31  |  26KB  |  492 lines

  1.  
  2.   
  3.   
  4.                         USER FLAGS UTILITY 
  5.   
  6.                         by Scotty Thompson 
  7.   
  8.                         Copyright (C) 1991 
  9.                         All Rights Reserved 
  10.   
  11.                            DOCUMENTATION 
  12.  ----------------------------------------------------------------- 
  13.   
  14.   
  15.                          COPYRIGHT NOTICE 
  16.   
  17.  This  Software  is Copyright (C) 1991 by  Scotty  Thompson.   All  
  18.  Rights  are reserved.  No part of this Software may be copied  or  
  19.  otherwise reproduced, without written consent of the Author,  for  
  20.  Profit.   This Software is to remain intact in its entirety.   No  
  21.  portions  of  this Software shall be utilized in any  manner  not  
  22.  intended  from  this  copyrighted  algorithm,  and  no  User   is  
  23.  authorized to modify the contents or distribute changes. 
  24.   
  25.  This Software is Shareware, i.e., the User may use this  Software  
  26.  provided that he/she register the product.  The registration  fee  
  27.  is $10.00 U.S. dollars or $5.00 with comments/suggestions.   This  
  28.  Software   may   be  distributed  AS-IS,   provided:   (1)   This  
  29.  documentation  is included with every copy, and (2)  distributors  
  30.  may  recover  the  cost(s)  of  distribution  by  increasing  the  
  31.  registration fee, so long as it is not ambiguous that the  above- 
  32.  mentioned registration fees are separate from any costs  recouped  
  33.  from  the  vendor, and that such registration costs are  for  the  
  34.  exclusive use of the Author. 
  35.   
  36.  The Author makes no warranty and takes no responsibility for  any  
  37.  damages of any kind that this Software may incur. 
  38.   
  39.  The current Registration Address is: 
  40.   
  41.                           Scott Thompson 
  42.                      1621 West 257th Street #2 
  43.                       Harbor City, CA  90710 
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.   
  51.  ================================================================= 
  52.   
  53.                              OPERATION 
  54.   
  55.   
  56.   
  57.  1.   UPLOADING TO THE HP48SX. 
  58.   
  59.       This  Software  is  a Directory for  the  HP48SX  containing  
  60.       various operating programs.  Select the Main Directory where  
  61.       you wish this Software to be placed as a Sub-Directory.  For  
  62.       example,  if  you  are in the {HOME}  directory,  this  will  
  63.       create a sub-directory of {HOME}.  If you are in a directory  
  64.       called  {A},  this will be a sub-directory of the  main  {A}  
  65.       directory.  This Software will work in any valid displayable  
  66.       directory.  It will not work if used as a backup object. 
  67.   
  68.       You must Upload this Software using Kermit.  Use Binary mode  
  69.       for     the     file    transfer.      Refer     to     your  
  70.       calculator's/computer's instructions on how to do this. 
  71.   
  72.   
  73.  2.   STARTING THE PROGRAM. 
  74.   
  75.       You  will need at least 30k of memory to run  this  program.   
  76.       After  a successful upload, press "VAR" to get a listing  of  
  77.       your  variables/programs.  Make sure that you are  logged-on  
  78.       to  the  main  directory  that  this  Software  has   become  
  79.       attached.  You should see part of the program name with  the  
  80.       directory  bar  indicator  above.  Press  the  key  that  is  
  81.       directly under the program name (the white soft-key). 
  82.   
  83.       Look  for  the file in the menu line that  says  "UFLA"  and  
  84.       press  the  key  directly underneath.   You  should  see  an  
  85.       initialization screen, followed by: 
  86.   
  87.                            User Flags Utility 
  88.                            by Scotty Thompson 
  89.   
  90.       as well as the following items in the menu line: 
  91.   
  92.                 HELP : REVW : DFLT : SETF : AUTO : EXIT 
  93.   
  94.       This  is the main menu.  We will review these keys in  order  
  95.       from left to right. 
  96.   
  97.       HELP: 
  98.            Pressing  this key will display a brief description  of  
  99.            what  these  menu keys are.  It should be  adequate  to  
  100.            refresh   your  memory  after  you  have   read   these  
  101.            instructions  and are familiar with the  software.   To  
  102.            leave this screen, press the "ENTER" key. 
  103.   
  104.       REVW: 
  105.            Pressing this key textually reviews the 64 system flags  
  106.            as defined by Hewlett-Packard for the HP48SX Revision A  
  107.            devices.  Upon first pressing this key, you may see the  
  108.            message "Creating File..." appear on the screen.   This  
  109.            message  appears whenever the system flags change  from  
  110.            the delta flag in the program.  Once this file has been  
  111.            created,  the system flags are stored in this area  and  
  112.            subsequent reviews will not have to rebuild the file. 
  113.   
  114.            To maneuver through this level, press the Left or Right  
  115.            graphics  cursor movement keys, integer keyboard  codes  
  116.            34 and 36, respectively.  In the menu bar, you will see  
  117.            numbers  that correspond to the flag(s) affected.   For  
  118.            example, the first page will have: 
  119.   
  120.                         1 : 2 : 3 : 4 : 5-10 : 11-12 
  121.   
  122.            in  the  menu area.  The seventh line shows  a  general  
  123.            cursor movement description.  Line six indicates  which  
  124.            Binary  Base is currently in effect.  As can  be  seen,  
  125.            there are six actual data lines, and the six menu items  
  126.            correspond  one-on-one  with the data lines,  with  the  
  127.            left-most  menu item corresponding to data line  number  
  128.            one. 
  129.   
  130.            A  short beep will be heard if you have  BEEPS  enabled  
  131.            and  you go from the beginning page to the ending  page  
  132.            and vice-versa. 
  133.   
  134.            To Exit this function, press the "DROP" key. 
  135.   
  136.            You will be taken back to the main screen with the main  
  137.            menu reappearing in the menu area. 
  138.   
  139.       DFLT: 
  140.            Pressing  this  key  immediately  brings-up  a  Caution  
  141.            screen.   This routine will reset the system  flags  to  
  142.            Hewlett-Packard's  defaults, as indicated by the  flag- 
  143.            list descriptions for the HP48SX Revision A device. 
  144.   
  145.            Press  "Y" to reset the flags to the default state,  or  
  146.            press "N" to leave the flags as they are.  You will see  
  147.            an  acknowledgment  screen shortly after  pressing  the  
  148.            correct key. 
  149.   
  150.            Press "ENTER" to leave the acknowledgment screen. 
  151.   
  152.            You will be taken back to the main screen with the main  
  153.            menu reappearing in the menu area. 
  154.   
  155.       SETF: 
  156.            Pressing  this  key is similar to the REVW  key  above.   
  157.            Refer to its description for explanations of when  this  
  158.            Software  will create the file and how it knows  if  it  
  159.            needs  to  be refreshed.  The difference  between  this  
  160.            routine and the REVW routine is that this will allow you  
  161.            to  set/change  the  various  flags  using  a   textual  
  162.            interface.  For example, you will be able to change the  
  163.            Clock  Format from "24 HR" to "12 HR" instead  of  "-40  
  164.            CF". 
  165.   
  166.            You  will  see the same textual descriptions  that  you  
  167.            will see in the REVW option, but you will know for sure  
  168.            that you're in SET/CHANGE mode because there will be  a  
  169.            reversed,   or  highlighted,  section  of  the   screen  
  170.            directly  positioned  on  the line  that  is  currently  
  171.            active. 
  172.   
  173.            You  have a sample cursor movement description on  line  
  174.            seven for each page.  Also, the same flag numbers  will  
  175.            appear  in the menu area.  Just like the  REVW  option,  
  176.            press the Left and Right graphics cursor movement  keys  
  177.            to  switch  pages, integer keyboard codes  34  and  36,  
  178.            respectively.   You will hear a short beep if you  have  
  179.            BEEPS enabled and you switch from the beginning page to  
  180.            the ending page or vice-versa. 
  181.   
  182.            To  move the highlighted pointer to select the  flag(s)  
  183.            to  change,  you  may press the Up  and  Down  graphics  
  184.            cursor movement keys, integer keyboard codes 25 and 35,  
  185.            respectively.  Also, you can press the softkey directly  
  186.            under  the flag number to go to that data area  on  the  
  187.            screen.   This is sometimes a quicker method to  select  
  188.            the desired flag. 
  189.   
  190.            Once  the  highlighted bar is on the flag you  wish  to  
  191.            change, press "ENTER" and the Flag Name will appear  on  
  192.            a new screen highlighted. 
  193.   
  194.            If the flag is indicated by Hewlett-Packard that it  is  
  195.            reserved,  or  not  in  use,  you  will  see  a  screen  
  196.            indicating  that these flags may not be set  with  this  
  197.            program.   If  you  use these  flags  outside  of  this  
  198.            program,  and select the DFLT option, these flags  will  
  199.            be  read  as zero bits.  This program  does  not  alter  
  200.            these  unused  flags unless the DFLT  option  is  used.   
  201.            Press "ENTER" to return to the flag selection screen. 
  202.   
  203.            If the flag is a single-bit flag, and in-use, you  will  
  204.            see a screen that displays the flag name in highlighted  
  205.            characters.   Below this, you will see a  "From:"  with  
  206.            the  current  status of the flag, and below  this,  you  
  207.            will  see  a "To:" with the optional new  parameter  to  
  208.            set.  Press "Y" if you wish to make the "TO" option the  
  209.            active  option,  or press "N" if you wish to  keep  the  
  210.            flag unchanged with the "FROM" option. 
  211.   
  212.            If  the flag is a multi-bit flag, and in-use, you  will  
  213.            see a screen that displays the flag name in highlighted  
  214.            characters.   Below this, you will see the "From:"  and  
  215.            "To:" options as indicated above.  However, instead of a  
  216.            'Yes and No' prompt, there will be in the display  area  
  217.            cursor movement instructions.  In each of these  cursor  
  218.            movement  cases, the Software expects you to press  the  
  219.            graphics  cursor keys.  For example, there may  be  the  
  220.            Left  and Right to increment/decrement a number by  10,  
  221.            decimal,  and  Up  and Down  to  increment/decrement  a  
  222.            number  by  1.  These cursor examples should  be  self- 
  223.            explanatory.  When the "TO" option holds the value that  
  224.            you  wish, press the "DROP" key to back-up or 'Drop'  a  
  225.            level.  Be careful not to hit the "DROP" key twice in a  
  226.            row  because  from the flag selection screen,  Drop  is  
  227.            used to exit this routine (see below). 
  228.   
  229.            When you are satisfied that your flags are the way  you  
  230.            like  them, press the "DROP" key to exit  the  routine.   
  231.            When  you  exit the application, any changes  you  made  
  232.            here will be reflected in the flags in use. 
  233.   
  234.       AUTO: 
  235.            This  is  the AutoSet option.  Pressing this  key  will  
  236.            prompt  you  through an assortment  of  options.   This  
  237.            routine will: (1) Let you first Review/Set your  flags,  
  238.            (2)  Allow  you to put your flags on  a  UserKey,  (2a)  
  239.            Create a Program that automatically runs a program from  
  240.            the  user keyboard and insures that your flags now  set  
  241.            replace any that the application run may have  changed,  
  242.            and  (3)  Allow you to create an AutoRun  program  that  
  243.            doesn't require the UserKey. 
  244.   
  245.            The  First  prompt will ask if you wish  to  Review/Set  
  246.            your  flags before continuing.  Press "Y" if  you  want  
  247.            the  program  to  shell to the SETF  routine  and  then  
  248.            continue  here, or "N" to continue through the  AutoSet  
  249.            routine. 
  250.   
  251.            If you elected "Y" above, refer to the SETF routine for  
  252.            instructions on how to Set/Change your flags. 
  253.   
  254.            The  Second  prompt will ask if you with  to  put  your  
  255.            Flags on a UserKey.  The UserKey allows you to  program  
  256.            any  of the keys on the keyboard, except for  the  "ON"  
  257.            key  proper,  to automatically load your flags  at  any  
  258.            time   the   USER  mode  is  on  and  you   press   the  
  259.            corresponding   key.    With  this  option,   you   can  
  260.            optionally   create   an   autoload   key   that   will  
  261.            automatically  run  your favorite  application  program  
  262.            after  first  setting the flags to your  options,  then  
  263.            restoring  the flags to your options upon return.   For  
  264.            example,   an  application  program  that  displays   a  
  265.            calendar  and  allows you to  make/change  appointments  
  266.            knowingly  changes  the system flags to  something  you  
  267.            don't want.  With this option (or, for that matter, the  
  268.            AutoRun  option,  below),  you can  simply  press  your  
  269.            "HotKey"   and   run  your   application.    When   the  
  270.            application is finished, your flags will be set to  your  
  271.            preference.  Throughout the nodes that require that the  
  272.            USER  mode be active, a friendly reminder is  displayed  
  273.            with each "FUNCTION COMPLETE!" screen. 
  274.   
  275.            Referring to the above paragraph, press "Y" if you wish  
  276.            to  program  a  UserKey, or "N" to  skip  to  the  next  
  277.            option.   If  you press "Y", you will  be  prompted  to  
  278.            enter the FULL KEY DEFINITION for the Key that you want  
  279.            to use to store this program.  This Full Key Definition  
  280.            means  that  if the user has to press the  Alpha  Left- 
  281.            Shift 5 to access the application, you must press Alpha  
  282.            Left-Shift  5 here.  If you decide that you don't  wish  
  283.            to assign a key after all, make sure that no shifts are  
  284.            active  and  that  alpha is  disabled.   Press  "ENTER"  
  285.            proper  if you still with to abort.  You needn't  worry  
  286.            about  wrong  keypresses and selecting  strange  modes.   
  287.            The  entire user keyboard is disabled  throughout  this  
  288.            program,  except for the "ON" key.  Do not  press  this  
  289.            key.   If you abort with "ENTER" proper, you  will  see  
  290.            another  screen that indicates that this  function  has  
  291.            been aborted.  Press "ENTER" at this point to  continue  
  292.            to the next option. 
  293.   
  294.            Referring to the above paragraph, and assuming that you  
  295.            wished  to assign the UserKey, if this  Software  finds  
  296.            that the key you choose was already assigned, a  screen  
  297.            will appear that asks if you wish to replace this  key.   
  298.            If  you press "Y", the old object assigned to that  key  
  299.            will  be  replaced  by a program  generated  from  this  
  300.            application.   If  you  press "N" at  this  point,  the  
  301.            program  will  cycle  to the beginning  of  the  Second  
  302.            option and ask if you wish to assign a UserKey. 
  303.   
  304.            Upon successful completion of assigning your UserKey, a  
  305.            FUNCTION  COMPLETE! screen will appear.  Press  "ENTER"  
  306.            to continue. 
  307.   
  308.            If you elected to program a UserKey, and did not abort,  
  309.            you  will  be  prompted on if you'd like  to  Append  a  
  310.            UserFile.  Press "Y" to enable this Software to  create  
  311.            a program that automatically runs one of your  programs  
  312.            from  the  key you just assigned.  The  flags  will  be  
  313.            stored  and  restored according to your  flags  options  
  314.            during  this session.  Refer to the "Select  Path"  and  
  315.            "Select File" sections on how to maneuver through these  
  316.            sub-sections.    Pressing  "N"  will  take  you  to   a  
  317.            "FUNCTION ABORTED!" screen.  Press "ENTER" to  continue  
  318.            to the next option. 
  319.   
  320.            The  Third option is to create an AutoRun  file.   This  
  321.            file  is not based on the keyboard and resides  in  the  
  322.            directory of your choice.  The file performs a  similar  
  323.            operation  to  the UserFile option above,  but  resides  
  324.            instead as a separate program with a fixed name.  Press  
  325.            "Y"  to create the AutoRun program.  If you  press  "N",  
  326.            you  will  be taken to the  FUNCTION  ABORTED!  screen.   
  327.            Press "ENTER" to leave this screen. 
  328.   
  329.            The  Last  screen for the AutoSet option is  a  summary  
  330.            screen.   You will see "AUTOSET STATUS" in reverse,  or  
  331.            highlight,  at  the top of the screen.   If  BEEPS  are  
  332.            enabled,  you will hear a series of tones and see  four  
  333.            information  lines  appear from bottom to  top.   These  
  334.            information lines are: 
  335.   
  336.            USERKEY  INDEX:  The Keyboard Code of the  UserKey,  or  
  337.            "N/A" if no UserKey was assigned during this session. 
  338.   
  339.            SET USERKEY: This will say "YES" or "NO", depending  on  
  340.            if  you set the UserKey during this session.  If  "YES"  
  341.            appears, the UserKey Index, above, will indicate  which  
  342.            Key was assigned. 
  343.   
  344.            APPEND   USERFILE:   This  will  say  "YES"  or   "NO",  
  345.            depending  on:  (1)  UserKey  was  Set,  and  (2)   You  
  346.            successfully  appended  a UserFile.   If  both  options  
  347.            above  are  true, a "YES" will appear  here,  otherwise  
  348.            "NO"  will appear.  This is handy to remember that  you  
  349.            have  a  program also assigned to the same key  as  the  
  350.            flag initialization routine. 
  351.   
  352.            MAKE AUTORUN: This will say "YES" or "NO", depending on  
  353.            if you elected to create an AutoRun program. 
  354.   
  355.            Press "ENTER" to complete the AutoSet routine. 
  356.   
  357.            You  will return to the main screen with the main  menu  
  358.            reappearing in the menu area. 
  359.   
  360.       EXIT: 
  361.            Press this key to End this session.  Any changes to the  
  362.            flags  will  be  current  and  operational.   Any  keys  
  363.            assigned   will  be  available,  along  with  any   key  
  364.            definitions upon entry to this program. 
  365.   
  366.                                     ----- 
  367.   
  368.                          SPECIAL SECTION FOR AUTOSET 
  369.   
  370.       SELECT PATH: 
  371.   
  372.            This  routine is part of the AutoSet routine.   If  you  
  373.            elect  to  add  a program to a user key  or  create  an  
  374.            AutoRun program, this will be the first screen that you  
  375.            see.   This  routine  will  go  through  the  different  
  376.            directories on your calculator, allowing you to  select  
  377.            the path for the program to be run. 
  378.   
  379.            The  first two lines are cursor  positioning  examples.   
  380.            The  third line indicates to press "ENTER" to End.   You  
  381.            press  this  key if you have agreed that  the  path  as  
  382.            indicated under the "MAIN LEVEL" highlighted section is  
  383.            the  path that your application will reside.  If  there  
  384.            is  any  data  in the "SUB LEVELS" section,  it  is  an  
  385.            indication  that the directory named in the Main  level  
  386.            has directories as indicated in the Sub level. 
  387.   
  388.            Press  the Left and Right graphics  cursor  positioning  
  389.            keys,  integer  keycodes 34 and  36,  respectively,  to  
  390.            cycle  the  sub-directories listed in  the  SUB  LEVELS  
  391.            section,  if any.  If this area is blank, it  indicates  
  392.            that  no sub-directories are present for the  directory  
  393.            shown in the Main Level section. 
  394.   
  395.            Press the Up and Down graphics cursor positioning keys,  
  396.            integer keycodes 25 and 35, respectively, to go up  one  
  397.            level  in the directory tree (keycode 25) or  down  one  
  398.            level  to  that currently displayed in the  SUB  LEVELS  
  399.            section.   Note  that  pressing Down when  no  item  is  
  400.            displayed in this section will have no effect. 
  401.   
  402.            Press  "DROP" to abort this operation.  If you do,  you  
  403.            will  be  returned to the "FUNCTION  ABORTED!"  screen.   
  404.            Press "ENTER" to leave this screen. 
  405.   
  406.            Please  note that the directory indicated in  the  MAIN  
  407.            LEVEL  will  be  the active  directory  for  subsequent  
  408.            program  listings.  If there is a sub-directory of  the  
  409.            {HOME} directory, for example, then you MUST press  the  
  410.            Down  cursor key to make what was in the  sub-directory  
  411.            the  current,  or parent, directory.  You may  wish  to  
  412.            practice  this  so that you will be confident  on  this  
  413.            routine's operation. 
  414.   
  415.       SELECT FILE: 
  416.   
  417.            This  is  the  Second screen that  you'll  see  if  you  
  418.            haven't  aborted  from the SELECT  PATH  routine.   The  
  419.            First option is to select the search parameter.   Press  
  420.            the  Left  and  Right graphics  cursor  movement  keys,  
  421.            integer keycodes 34 and 36, respectively, to cycle  the  
  422.            search  choices.  Pressing "DROP" on this  screen  will  
  423.            abort  the  operation  and take you  to  the  "FUNCTION  
  424.            ABORTED!" screen.  Press "ENTER" to leave this  screen.   
  425.            When  you  have  selected  a  search  parameter,  press  
  426.            "ENTER".   Pressing  ENTER  will  display  "WAIT"  text  
  427.            directly  under the search parameter for a short  time.   
  428.            If  there are no matches for the type of data  you  are  
  429.            requesting,  the routine will stay on this  screen  and  
  430.            the "WAIT" text will disappear.  If there are  matches,  
  431.            a  second  screen will appear with  the  search  option  
  432.            highlighted at the top of the screen.  Line seven  will  
  433.            have  a  cursor positioning example,  and  towards  the  
  434.            middle  will be a name of one of the data that met  the  
  435.            criteria.   Press  the Left and  Right  graphics  cursor  
  436.            movement   keys,   integer   keycodes   34   and    36,  
  437.            respectively,  to  cycle through the options.   If  you  
  438.            reach the data you want, press "ENTER" and the path and  
  439.            name  will  be  used  to create  the  program  for  the  
  440.            UserFile and/or AutoRun routine.  If you wish to select  
  441.            a  different search option, instead, press  the  "DROP"  
  442.            key  at  this level and you will be taken back  to  the  
  443.            Search option screen.  If you wish to fully abort,  you  
  444.            may press "DROP" on this screen only.  Pressing  "DROP"  
  445.            on  the  second screen will simply take  you  back  one  
  446.            level. 
  447.   
  448.            Like the SELECT PATH routine, you may wish to  practice  
  449.            to get used to the "feel" of the software. 
  450.  
  451.  
  452.  
  453.   
  454.                                ----- 
  455.                                NOTES 
  456.                                ----- 
  457.   
  458.       If  you have already created an AutoRun program  and  select  
  459.  the  AutoRun filename as a new AutoRun name, the AutoRun  program  
  460.  will  recursively call itself and seemingly lock-up.  This is  to  
  461.  be  avoided.  The AutoRun name is displayed at the completion  of  
  462.  setting  the  AutoRun, so do be aware of  this  possibility.   No  
  463.  checking is done in cause the user wishes to modify this  AutoRun  
  464.  program  and  for some reason wishes recursion.  It is  for  this  
  465.  reason  that  no  software check is made to  check  the  reserved  
  466.  AutoRun filename. 
  467.   
  468.       At  no point should the User press the "ON" key  during  any  
  469.  stage  of this program's execution.  However, if you do, and  you  
  470.  think  you're  stuck, you're not.  Simply press  the  upper-right  
  471.  most  key (where the EXIT menu name appeared) and you  will  exit  
  472.  the  application without any problems.  Also, you're  flags  will  
  473.  remain  intact and you shouldn't lose any sleep with  the  abort.   
  474.  Simply  restart  the  application, if you  wish.   If  you  don't  
  475.  restart the application after an accidental abort and exit, there  
  476.  is  no  worry.   All system states are  restored  with  the  EXIT  
  477.  routine, which is assigned to that key. 
  478.   
  479.       I recommend dedicating one UserKey just to initializing  the  
  480.  flags.   If you wish to append files, select different keys,  but  
  481.  keep  at  least one key not assigned to a program  for  autoload.   
  482.  This  is  useful if you simply want to restore  the  flag  states  
  483.  without running another application. 
  484.   
  485.       This version doesn't allow for multiple flag indexes due  to  
  486.  possible  size  limitations of non-expanded  calculators.   Every  
  487.  effort  was made to keep the size to a minimum and provide  fast,  
  488.  powerful and friendly code.  Your comments/suggestions are always  
  489.  welcome.  I hope you get as much use out of this program as I do.   
  490.  Enjoy. 
  491.  
  492.